home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 001a / lc100.zip / LC.DOC < prev    next >
Text File  |  1991-07-04  |  40KB  |  1,056 lines

  1. This program is Shareware, and
  2. may be distributed freely, so-
  3. long as the original archive
  4. is not tampered with. - Author
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.                                Lcom v1.0 
  36.  
  37.                                     ∙
  38.  
  39.                          Written by John Bushnell
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.         I.      Overview of supplied files
  74.        II.      Setting up Lcom for use
  75.       III.      Using the program
  76.        IV.      Author's Notes
  77.  
  78.                 A.  Getting Help
  79.                 B.  The Terminal
  80.                 C.  Controlling The Modem
  81.                 D.  General Defaults (Controlling Variables Within the Program)       
  82.                 E.  Telephone (Dialing) Directory
  83.                 F.  Telephone Directory Special Terminal Service Keys
  84.                 G.  The ScrollBack Buffer
  85.                 H.  Macros (In General)
  86.                 I.  Macros (Incoming)
  87.                 J.  Translate Tables
  88.                 K.  Ascii Tables
  89.                 L.  Transfer Protocol Areas
  90.                 M.  Shelling To Dos
  91.                 N.  Changing Video Modes (screen length, width, color/b&w, etc)
  92.                 O.  Controlling the Lcom Menus (sizes, colors, positions, etc)
  93.                 P.  Zooming
  94.                 Q.  Viewing the DOS screen
  95.                 R.  Saving the screen (record screen)
  96.                 S.  Printing The Screen
  97.                 T.  Log to File (protocol:ascii download)
  98.                 U.  Log to Printer
  99.                 V.  Sending the modem init string manually
  100.                 W.  Hanging up the modem
  101.                 X.  Exiting the program
  102.                 
  103.                 
  104.                 
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                        ┌──────────────────────────┐
  120.                        │OVERVIEW OF SUPPLIED FILES│
  121.                        └─────────────I────────────┘
  122.  
  123.  
  124.         Lcom comes with three executable files:
  125.  
  126.                 LCC.BAT   - The Lcom Configuration program.  You use this to
  127.                             install Lcom initially (this will be the first
  128.                             program you run) and whenever you wish to change
  129.                             an option within the Lcom.
  130.  
  131.                 LC .EXE   - Lcom.  The main program.
  132.  
  133.                 LCV.EXE   - The Lcom Video Configuration program.
  134.                             Change your video mode to each video mode you
  135.                             would ever want to run Lcom in, and run LCV in
  136.                             each so that Lcom can know a little information
  137.                             about the modes it will be used in.  Lcom will
  138.                             run in any screen size, from 40x25 to 200x127.
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.                         ┌───────────────────────┐
  147.                         │SETTING UP LCOM FOR USE│
  148.                         └───────────II──────────┘
  149.  
  150.  
  151.         To setup Lcom for use, refer to the INSTALL.DOC file for detailed
  152. instructions on the most basic configuration to the most comprehensive.
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.                             ┌─────────────────┐
  166.                             │USING THE PROGRAM│
  167.                             └───────III───────┘
  168.  
  169.  
  170.  
  171.  
  172.  
  173.                               A. GETTING HELP
  174.  
  175.  
  176.  
  177.  
  178.  
  179. Help is available from any part of the program through the help key; defaulted
  180. to be F1.  After pressing F1, help information specific to the area of the
  181. program which you are in will be shown.  Pressing F1 again will give you help
  182. on the help window.  In short, the arrow keys allow you to move up and down
  183. through the help material (if more than one page exists) and the escape key
  184. leaves.
  185.  
  186.  
  187.  
  188.  
  189.  
  190.                             B. THE TERMINAL
  191.  
  192.  
  193.  
  194.  
  195.  
  196. When you first run Lcom you enter the terminal window.  From here, all the 
  197. other windows which you can access while using Lcom, such as the telephone
  198. directory and macros, are available by pressing the appropriate keys.
  199.  
  200. The terminal has several options which you can select.  These include the
  201. emulation which is being used to translate commands over the modem and
  202. whether or not characters you type are echoed on the screen or not.  These
  203. options can be set in two places.  The first is in the config program; Changes
  204. made here are permanent.  The second is through the General Defaults window.
  205. Most changes made from this window are lost when you rerun the Lcom.  You
  206. would normally change the settings in the config program if you want them to
  207. be still set every time you run Lcom.
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.                        C. CONTROLLING THE MODEM
  215.    
  216.  
  217.  
  218.  
  219.  
  220.  
  221. The Line Settings window (ALT-L) is the window which shows you what your modem
  222. is currently configured to, and, allows you to change that configuration.
  223. Items that can be changed include the baud rate, parity, character length,
  224. stop bits, com port, and com port base address.  You move to each of the
  225. different items that can be changed by using the right and left arrow keys.
  226. To change the value of the currently highlighted option, press the up or down
  227. arrow keys.
  228.  
  229. All of the items in this window can also be changed in the config program;
  230. however, be forewarned that if you change the com port in the config program,
  231. you must (also) change the com port base address to correspond to your (new)
  232. com port.
  233.  
  234.  
  235.  
  236.  
  237.  
  238.                           D. GENERAL DEFAULTS
  239.  
  240.  
  241.  
  242.  
  243.  
  244. The general defaults window is a window inside of the Lcom program which allows
  245. you to temporarily change options which Lcom uses while it is running.
  246. Examples include the terminal emulation, duplex, init string (this will be
  247. changed permanently), and how long the dial waits for a connection before
  248. giving up.
  249.  
  250.  
  251.  
  252.  
  253.  
  254.                E. TELEPHONE DIRECTORY (DIALING DIRECTORY)
  255.  
  256.  
  257.  
  258.  
  259.  
  260. The Lcom telephone directory (defaulted to be the ALT-D key) is the method by
  261. which you store the phone numbers of people you wish to call, and, to call and
  262. connect to those numbers.  Lcom supports up to 65,000 numbers (infinite for all
  263. intents).  You can move throughout the different numbers using the up and down
  264. arrow keys, as well as the page keys and the home and/or end keys.
  265.  
  266. The telephone directory operates off of a command line system; that is, where
  267. you type in any command you wish to use in verbose; i.e. "sort".  There are
  268. some 'givens', however.  These include:
  269.  
  270.       - Pressing return on a blank line issues the dial command.  If any
  271.         numbers are marked (in the que) they are dialed, otherwise, the
  272.         number you are currently on is dialed.
  273.  
  274.       - Pressing the space-bar issues the "mark" command; which adds the
  275.         current entry into the que.
  276.  
  277.       - ALT-E issues the EDIT command; which edits the current number.
  278.  
  279.       - Typing in a word which is not a command, such as "whatever", is then
  280.         assumed by Lcom to be a search string.  A search for that word is
  281.         started, and if it is found, the highlighted bar is moved to that
  282.         number.  This is useful for quickly finding certain number.  If you
  283.         had a number which, for instance, you labeled as "John's BBS", you
  284.         could just type in "john" and Lcom would go directly to that number.
  285.  
  286.  
  287.  
  288. Lcom has many commands available for your use in the telephone directory.  You
  289. can type them out manually or simply type the RIGHT ARROW (or '/' key) and
  290. thumb through the list of commands and choose the one you want; either with the
  291. enter key which executes the command immediately, or the space bar which types
  292. out the command for you up to the point where you would press enter, but does
  293. not.
  294.  
  295. Here is a complete listing of the dialing directory commands:
  296. -------------------------------------------------------------
  297.  
  298.         dial ∙ This dials a number or numbers which are specified after the
  299.                command, in the que; or if neither of these exist, the currently       
  300.                highlighted number.
  301.  
  302.         once ∙ This command is the same as the dial command, except that the
  303.                dial command repeats after an unsuccessful attempt.  The once
  304.                command dials the specified number(s) once, and then stops.
  305.  
  306.         edit ∙ (Also ALT-E) this command pulls you into the telephone edit
  307.                window.  From there, you can enter in things such as the
  308.                phone number's name, number, and baud rate.
  309.  
  310.         goto ∙ This allows you to immediately go to the number of your choice.
  311.                You can either tell the telephone directory to go to a specific
  312.                number (i.e. "goto 10") or a specific name.
  313.                (i.e. "goto compuserve")  If you are going to use the second
  314.                method, then you can (in almost all cases) drop the "goto".
  315.  
  316.         mark ∙ Marking a number "adds it to the que".  This means, that it
  317.                labels that number such that when you dial, all other labeled
  318.                numbers are dialed one after another until a connection.
  319.  
  320.       unmark ∙ After marking a number, you may wish to un-mark it.
  321.  
  322.         find ∙ This command is the same as the goto command; except that
  323.                it searches for the number you want assuming the string you
  324.                pass it is part of the name at all times.  With goto, if
  325.                you were to say "goto 10", it would assume you meant the 10th
  326.                number; whereas find assumes you wanted to find the number
  327.                which had a 10 in the name.  i.e. "...10... bbs".
  328.                format: "find <whatever>".
  329.  
  330.         copy ∙ This command allows you to duplicate a number.
  331.                "copy 10" would copy the number you are currently highlighting
  332.                to entry #10.
  333.  
  334.        clear ∙ Erases all information inside of the number indicated.
  335.  
  336.       delete ∙ This deletes the "slot" held by the number you deleted.
  337.                see: insert.
  338.  
  339.       insert ∙ Lcom does not come with any "slots" for you to put your phone
  340.                numbers in.  You have to create them as you need them.  This
  341.                is done by the "insert" command.  Hypothetically, this should
  342.                be the first command you ever type in the dialing directory.
  343.                After inserting a number, you would then want to edit it with
  344.                the edit command.
  345.  
  346.         swap ∙ If you ever want to swap one number with the place held by
  347.                another, use the swap command.  "swap 10" will swap #10 with
  348.                the currently highlighted number.
  349.  
  350.         sort ∙ You can sort your phone list by any of several methods.
  351.                These include name, number, and activity.  If you don't specify
  352.                a field, (i.e. sort 10-20) then Lcom sorts the entire list.  If
  353.                you wish to sort in reverse order, then specify the field in 
  354.                reverse. (i.e. sort 20-10).
  355.  
  356.         open ∙ You may have more than one telephone directory.  If so, you
  357.                can load a new one or edit an old one by typing "open fname".
  358.                "LC" is the standard dialing directory file.  Therefore, if you
  359.                wish to open your original dialing directory, you would type
  360.                "open lc"
  361.  
  362.         help ∙ Pulls up local help on the telephone directory.  This is
  363.                also the help key (F1).
  364.  
  365.         zoom ∙ Expands or unexpands the telephone directory window.  This is
  366.                also the zoom key (F5).  Sometimes even in Zoomed mode there
  367.                is more information to be displayed.  This information can
  368.                be displayed by moving over right using the ctrl-right-arrow
  369.                key.  This key also works while not zoomed.
  370.  
  371.          out ∙ This command is purely for your own convenience.  If you ever
  372.                wish to send a number or numbers over the modem, i.e. to tell
  373.                a friend the number to a certain bbs, you can simply use the
  374.                out command and Lcom types it for you.
  375.  
  376.        reset ∙ There is information stored in every number in the telephone
  377.                directory.  Some of this information is visible to you, such
  378.                as the number of times you've called a certain BBS; other
  379.                information is not, such as the activity index.  All of these
  380.                can be reset with the "reset" command.  This does *not*
  381.                erase important information such as the number or name of that
  382.                entry.  
  383.  
  384.         exit ∙ verbose equivalent to the escape key.
  385.  
  386.  
  387. The format by which you use these commands follows these rules:
  388.  
  389.     "dial"        ∙ A command with no other information specified assumes that
  390.                     you wish that command to apply to the currently highlighted
  391.                     number.  If you were on entry #1, this command would dial
  392.                     that entry.
  393.  
  394.     "dial 1"
  395.     "dial 1,2,3"  ∙ Any numbers after a command represent the numbers that
  396.                     the command is to apply to.
  397.  
  398.     "dial john"   ∙ If a non-number is specified, Lcom will attempt to figure
  399.                     out which number you were referring to, and use the
  400.                     appropriate number if found.
  401.  
  402.     "dial 1-20"   ∙ Specifying a field is done using a dash.  If you ever want
  403.                     to perform the function in reverse, specify in the field
  404.                     in reverse, i.e. "dial 20-1"
  405.  
  406.     "dial 100-"   ∙ (100 - end)    Dashes ( - ) signify a field. (as stated
  407.     "dial -100"   ∙ (1 - 100)      above).  If you leave out the first part
  408.     "dial - "     ∙ (1 - end)      of a dash statement, that piece is assumed
  409.                                    to have been a '1'.  If you leave out the
  410.                                    second part, that part is considered to be
  411.                                    the end of the telephone directory, thus,
  412.                                    the statement "dial 10-" will dial all
  413.                                    numbers from #10 to the end of the telephone,
  414.                                    dial "-10" from #1 to #10, and, "dial - "
  415.                                    will dial all numbers.
  416.  
  417.                   
  418.  
  419. combinations are accepted for most commands:
  420.  
  421.     "dial 1,2,3,john,1-20"
  422.  
  423. *Note:  There are several commands which allow only specific types of entry
  424.         specifications.  One such example is the sort command.  The only two
  425.         possibilities for the sort command is just "sort", or "sort <field>",
  426.         i.e. "sort 1-10", or "sort 10-1", but "sort 1,2,3" would be invalid.
  427.  
  428. Many times, it is not necessary to list the entire command.  If you list only
  429. part of a command, such as "di" instead of "dial", or even "d", lcom will
  430. assume you meant dial.  In the case of similar commands, such as "out" and
  431. "once", if you say "o", lcom will assume the command you wanted was the first
  432. one in the list.
  433.  
  434. If you are having trouble getting started with the telephone directory, try
  435. these steps:  type "ins<ENTER>", then ALT-E.
  436.  
  437.  
  438.  
  439.  
  440.  
  441. THE EDIT WINDOW
  442.  
  443.         After invoking the edit command, a window will pop up which will
  444. display all the information which you can change for the number you are
  445. editing.  To edit a certain item, type the letter which corresponds to it.
  446. For example in the case of the baud rate, the letter that corresponds to
  447. it is a 'B'.  This is found directly below the baud.
  448.  
  449.         38400
  450.          ^
  451.          │
  452.          B
  453.  
  454. For most applications, you will need only to edit the name and phone number
  455. of a new BBS, as the other information would most likely be the same as
  456. it is defaulted.
  457.  
  458.  
  459.  
  460.  
  461.  
  462. WHEN DIALING, AND THE DIAL WINDOW
  463.  
  464. Lcom has a unique style of dialing.  You need not be *in* the dial window
  465. to be dialing.  As Lcom is configured, when you start a dial the dial window
  466. will not appear.  You will be in what is called "roam mode".  In roam mode,
  467. you can move throughout Lcom while it is dialing.  If you type ALT-D to
  468. go into the dialing directory, you will instead go into the "dial window".
  469. Here you will find a list of various commands that you can type to do different
  470. things while dialing.  Options include: going to the next number in the que
  471. (n) redialing the previous number (p), and redialing the same number (r).
  472. If you press ESCAPE from the dialing window, you abort the dial.  You can,
  473. however, return back to the terminal (still dialing) and still be in roam mode.
  474. This is done by pressing ENTER in the dialing window.  All of the commands
  475. which are available in the dialing window are also available in the terminal.
  476. Because of this, you can simply press ESCAPE in the terminal to stop the dial,
  477. and in the same way you can press 'N' to go to the next number.
  478.  
  479. You can, if you wish, configure Lcom to automatically pull up the dialing
  480. window when you first start to dial.  This is the format most communication
  481. programs use, and in Lcom it is present simply as an aid you can use to view
  482. your options.  Think of it as a help menu.
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.             F. TELEPHONE DIRECTORY SPECIAL TERMINAL SERVICE KEYS
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496. There are two keys available from the terminal which perform several dialing
  497. functions.  The first, which is defaulted to be the ALT-R key, is redial.
  498. When you press this key, you start a redial of the last number you connected
  499. to, or attempted to call.  If you had several numbers in the QUE, they will
  500. be ignored in the "redial" option.
  501.  
  502. The second key is the "dial que" key. (defaulted to be ALT-Q).  Lets say you
  503. had four numbers in your dial que when you connect to one of them.  After you
  504. disconnect, you may want to start dialing the others again.  One way to do this
  505. is to go into the dialing directory and press enter.  This starts the dial, and
  506. since there are still the other three numbers in the que, those numbers are
  507. dialed.  Another option, however, is to use the "dial que" key.  This key, for
  508. all purposes, is exactly the same as going into the dialing directory and
  509. restarting the dial process over again; except simplified into one key.  Also,
  510. the ALT-Q key starts the dial in the que where you left off before, whereas
  511. going into the dialing directory and pressing enter restarts the dial off of
  512. the first marked number.
  513.  
  514.  
  515.  
  516.  
  517.             
  518.  
  519.                        G. THE SCROLLBACK BUFFER
  520.  
  521.  
  522.  
  523.  
  524.  
  525. There will invariably be times when you wish to review over information you
  526. had passed over before.  You can look over the information that had come in
  527. earlier by going into the Scrollback Buffer. (defaulted to be the ctrl-left-
  528. arrow key).  Lcom has what I have dubbed to be a non-volatile scrollback.
  529. That is, when you quit Lcom you do not loose that information and so it is
  530. still there when you rerun the program.  Lcom also, unlike many other programs
  531. (all of the ones that I know of) does not store the entire scrollback buffer
  532. in RAM.  Instead, Lcom has a service area (around 8k) where the information
  533. goes to be put into the scrollback buffer, and once 8k is filled that
  534. information is then passed on to a file on your hard disk and permanently 
  535. stored.  By doing this, Lcom has a virtually limitless pool of storage for
  536. the scrollback buffer.  The default size of the scrollback buffer is 1megabyte,
  537. (or 1,000,000 bytes / 1,000 K ).  This could be considered large and you might
  538. want to reduce the size of the backscroll in the config program.  You may even,
  539. however, want to increase this size to be able to "go back" further.
  540.  
  541. The two key components of the scrollback storage is the UNIT SIZE, and the 
  542. NUMBER OF UNITS.  If you have a UNIT SIZE of 8000bytes, and 128 units, then
  543. your scrollback buffer will be 1,024,000 bytes on disk (as it is defaulted).
  544. If you wanted to increase or decrease the size of the backscroll, the fastest
  545. and best way would be to change the number of units.  If you cut the number of
  546. units in half to 64, then you would cut the scrollback buffer size in half.
  547. If you ever change the unit size, be aware of these facts:  Increasing the
  548. unit size increases Lcom's size in RAM, and decreasing the unit size decreases
  549. the program's efficiency on disk, since about Lcom must waste approximately
  550. 240bytes of each unit.
  551.  
  552.  
  553.  
  554.  
  555.  
  556.                               H. MACROS
  557.  
  558.  
  559.  
  560.  
  561.  
  562. Macros are the way by which you can set up a particular key to type out
  563. a group of keys for you automatically.  You might, for instance, make a
  564. key to type out your name, i.e. "John Bushnell", and your password "whatever",
  565. separated by carriage returns.  You might also want to make a macro which
  566. automatically starts a transfer using a specific protocol, or even make a
  567. macro to dial a certain number.  Macros, put simply, simplify repetitive tasks.
  568.  
  569. Macros are present in several parts of the program.  There are, obviously, a
  570. list of macros which you can define in the macro window.  There are also
  571. two macros for each number in the dialing directory; one executed when you
  572. first connect to a BBS, and the other just after you disconnect.  There's a
  573. macro which is executed when you first run lcom (called the bootup macro)
  574. and also one which is run just before Lcom quits.
  575.  
  576. The general rule for macros is that when the scrolllock light is off, you
  577. are typing in regular words, like "hello".  When the scrolllock light is ON,
  578. you are in what is called "direct type mode".  In this mode, anything and
  579. everything which you type (other than shift, alt, ctrl, and keys like that)
  580. are recorded into the macro.  Even ESCAPES and ENTERS are stored.  The only
  581. key which is not recorded is the help key.  By going into direct type mode,
  582. you can type in commands such as ALT-D to go into the dialing directory,
  583. and the ENTER key to dial the current number.  By making such a macro, you
  584. would have in effect duplicated the (DIAL QUE) key for the dialing directory.
  585.  
  586.  
  587.  
  588. IN THE MACROS WINDOW
  589.  
  590.  
  591.         In the macros window, you have a list of "slots" where you can place
  592. macros.  The process of making a macro is as follows:  First, you would most
  593. likely want to give that macro its keystroke.  You can make a macro any key
  594. you want, however you shouldn't make it the same key as something which is
  595. already used.  Almost all of the ALT-Keys have been used by Lcom's different
  596. windows, and the F1 and F5 key are also used.  When you try to define a macro
  597. as a key already used by Lcom, a warning is displayed which says that "you
  598. will be masking out another key".  I only allow you to mask out another key
  599. since there may come a time when you would want to.  This might be so that you
  600. could do a few other things before actually going into the window originally
  601. occupied by the key you were masking over.
  602.  
  603.         You define the key for a macro by first pressing the CTRL-LEFT-ARROW
  604. key.  After pressing that key, you will see a box appear on the left hand
  605. side of the window prompting you to type the key you would like that macro to
  606. be.  You would then type in your key, for instance, ALT-F10.  Then you can type
  607. in your macro.  All letters, numbers, and symbols are accepted; and, once
  608. again, if you want to type in keys like the ALT or F-Keys, turn on the scroll
  609. lock light, type them in, and shut the scrolllock like off again.
  610.  
  611.         There are various commands which can be built into the macros to be
  612. interpreted as the macro is executed.  These commands start with a tilde (~)
  613. and are followed by a letter representing a specific corresponding command,
  614. and may be followed by other letters to be used by that command.  An example
  615. of this is the ~C command, which is substituted at run-time by the key which
  616. executed the macro.  There is another command for producing sound (~S).  This
  617. command requires that you follow the command by the frequency.  i.e. ~S▒ .
  618. The ▒ that you see you may recognize as the ASCII character #177.  You
  619. produce this character by pressing the ALT key, and while holding the ALT key
  620. typing in 1 7 7 (ON THE KEYPAD) , and then releasing the ALT key.  By putting
  621. that character in after the ~S command, you are telling lcom to create the
  622. sound with the frequency 177, or more specifically, frequency 177*100.  But you
  623. also need one more component with the sound command, you also need a "duration"
  624. ; that is, the length of the tone.  The duration comes directly after the
  625. frequency and is represented the same way: by a symbolic character that you can
  626. produce by pressing the ALT key, typing in the number into the keypad (1-255)
  627. and releasing the ALT key.  A complete example of the sound command would be
  628. ~S▒░ . The first symbol is character #177, and the second is #176.  In this
  629. example, you would be telling Lcom to produce the frequency 177 for 176 clock
  630. ticks.  (there are roughly 18 (20) clock ticks in one second).
  631.  
  632. A more complete list of commands is available in the HELP menu for the macros.
  633. In that help menu you will find commands listed in a "format".  The format
  634. for the sound command would be found as   ~Sfd  .  The F stands for the
  635. frequency, and the D the duration.
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.                         I. MACROS (INCOMING)
  643.  
  644.  
  645.  
  646.  
  647.  
  648. Probably the most powerful option in Lcom is the incoming macros.  These
  649. are macros which are triggered by, instead of keys, words that come in over
  650. the modem.  When you press the ctrl-left-arrow key, instead of prompting you
  651. to type in the key that would trigger the macro (to the right), you are typing
  652. in the string which will run that macro.  In this way you can automatically
  653. log yourself onto bulletin boards or create an "auto-zmodem".
  654.  
  655. Auto-Zmodem is a feature which exists on a few communications programs.  This
  656. is where a Zmodem transfer is initiated by the computer which that program
  657. is connected to, and the communications program automatically starts the
  658. same transfer.  Zmodem sends out the characteristic characters **B00 just
  659. before it starts to send a file. (the  is character #24).  You could, for
  660. instance, make an incoming macro which is triggered by **B00 and goes into
  661. the Download window (PgDn) and goes to the External Zmodem protocol (which
  662. you had added previously) and presses Enter.  You can go specifically to
  663. any protocol by typing in the sequential letter that corresponds to that
  664. protocol.  i.e. the first protocol would be "A", the second "B", and so on.
  665.  
  666. For a list of the commands and limitations of macros, read the previous
  667. section on MACROS.
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.                         J. TRANSLATE TABLES
  675.  
  676.  
  677.  
  678.  
  679.  
  680. Lcom has three different types of translate tables.  The first is an "incoming
  681. character" translate table, the second an "outgoing character" table, and the
  682. third is a "color" translation table.  Translation tables take one 'thing' and
  683. translate it to another.  For instance, in the case of the color table;  you
  684. could change one color to be another.  You may want to do this because it is
  685. hard to read that particular color combination on your monitor; who knows.
  686. The outgoing translate table takes the letters you type and will translate them
  687. into a different letter, and the incoming table takes the letters as they come
  688. in and changes them before it displays them on the screen.
  689.  
  690. A couple notes about the character translate tables:
  691.  
  692. when you start changing characters around, you may experience some 'weird'
  693. results.  The first of which is that characters are translated AFTER they
  694. are checked by the incoming macros.  This means that your incoming macros
  695. only apply to that which exactly comes in over the modem.  Secondly, if you
  696. ever translate character #27 then the ANSI color and control process will
  697. stop working (assuming you are using the ANSI emulation; which you probably
  698. are.)
  699.  
  700.  
  701.  
  702.  
  703.                           K. ASCII TABLES
  704.  
  705.  
  706.  
  707.  
  708.  
  709. An Ascii Table is a list of all the characters on your IBM computer.
  710. In this table you will find a list of letters and symbols with their
  711. corresponding numbers.  If you want to produce any of these symbols
  712. (or letters) the procedure you use to do this is as follows:
  713.  
  714. First press and hold the ALT key, then while holding the ALT key, type in the
  715. number of the symbol (ON YOUR KEYPAD, NOT ON THE NUMBERS ABOVE THE LETTERS)
  716. and then, release the alt key.  <- That, is the process by which you can
  717. create these symbols just about anywhere.  While you are in the ascii table,
  718. if you wish to send one of these characters out over the modem, one easy way
  719. is to simply move the highlighted bar over the symbol and then press and
  720. release the enter key.
  721.  
  722. Most likely you will use this as a "reference" guide.
  723.  
  724.  
  725.  
  726.  
  727.  
  728.                       L. TRANSFER PROTOCOL AREAS
  729.  
  730.  
  731.  
  732.  
  733.  
  734. Lcom uses what are called "external protocols".  I've found through my OWN
  735. experiences with communications programs that internal protocols are often
  736. 'behind the times'.  This means slow, buggie, and devoid of newer features
  737. which have since been added.  External protocols, or protocols which are
  738. separate programs, can be found on any protocol which you could ever want;
  739. and they are almost always more current and easier to update (so you don't
  740. have to keep getting newer versions of Lcom).
  741.         If you are unfamiliar with the procedures associated with using
  742. External protocols, here is a brief summary:  The most common external
  743. protocol program is called "DSZ".  This program contains inside of it
  744. the Xmodem, Ymodem-Batch, and Zmodem protocols.  Which protocol is being
  745. used depends on what you tell it to use when you are setting it up.  You
  746. would, for instance in the case of DSZ, use that program three different ways:
  747. one for each protocol.  After you have created an external protocol definition
  748. (see below), You will type in the filename and parameters for both uploading
  749. and downloading.  For the Zmodem protocol, your filename and parameters for
  750. Uploading would be, for example: "c:\path\dsz port 1 sz %f".  c:\path\dsz
  751. would probably not be where you put your external protocol, but it happens to
  752. be where mine is.  You would put in the path to your own external protocol
  753. program.  Also, I put in "port 1" because I'm on Com 1... if you are on com 2
  754. then you should put "port 2" for DSZ.  Or, you could even put "port %c" since
  755. Lcom automatically translates "%c" into the current com port number.
  756.         After you have entered in this "string" into the external protocol
  757. edit menu (alt-e) for both upload and download, then you are ready to go.
  758.  
  759.  
  760. Creating an External Protocol Definition
  761. ----------------------------------------
  762.  
  763. To create a new external protocol, press the insert key.  Then, to edit it,
  764. (so as to enter in the upload and download strings, as well as the name) type
  765. ALT-E (while on that protocol).
  766.  
  767.         
  768.  
  769.  
  770.  
  771.  
  772.                           M. SHELLING TO DOS
  773.  
  774.  
  775.  
  776.  
  777.  
  778. After going into the SHELL window, you then have two options: either doing
  779. a L:ocal shell or a R:emote (and local) shell.
  780.  
  781. The Local Shell is a normal dos shell.  The Remote Dos Shell is a unique shell
  782. in which you, and your remote partner, can both shell to (your) dos at the
  783. same time.
  784.  
  785. The Remote Shell
  786. ----------------
  787.  
  788.         A few notes about the remote shell,
  789.  
  790.         You shouldn't use this unless you are ONLINE.  If you do it while you
  791.         are offline, you will most likely experience a "loop back" and the
  792.         computer will (seem) to lock up.  If this occurs, turn the scrolllock
  793.         light ON.
  794.  
  795.         Turning the scrolllock light ON makes it so that characters are not
  796.         allowed from over the modem.  This means that your partner cannot
  797.         type, and if he/she hangs up while you are in a remote shell (and
  798.         a loopback occurs) you can simply turn the scrolllock light on and
  799.         things will "flush" themselves out eventually.
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.       N. CHANGING VIDEO MODES (SCREEN LENGTH, WIDTH, COLOR/B&W, ETC.)
  807.  
  808.  
  809.  
  810.  
  811.  
  812. There are problems with changing the screen size on the IBM computer.  Going
  813. to 80x43 or 80x50 is fairly generalized by all video cards, and so I *could*
  814. make it so you could switch into these screen sizes, however, if I used that
  815. system then you could never go into, lets say, 132 columns, or my favorite,
  816. 100x60.
  817.  
  818. Most video cards come with some sort of utility program to change the screen
  819. size into 80x43, 80x50, 132x43 (whatever is supported).  For my video card
  820. the program is called "ESU".  I type ESU /3 for 80x25 and ESU /40 for 80x43.
  821.  
  822. The idea behind Lcom is that for every video mode that you would ever wish to
  823. go into, you would run LCV (the lcom video utility) and configure Lcom for that
  824. screen size individually.  After you've done 80x25, you'd then run your
  825. change-screen-size program that came with your video card and switch to the
  826. next mode that you might want to use.  After you've changed, then you'd rerun
  827. LCV and configure for that screen mode.  Configuring for a screen mode involves
  828. simply going into LCV, into the Change-mode-parameter-area, and typing in the
  829. command which would set your screen size to that mode at dos.  i.e. "ESU /3"
  830. (goto 80x25 for Video7 video cards).
  831.  
  832. After you've configured all of the modes you would ever want to use, you can
  833. then go into them from the ALT-V (defaulted to) window.
  834.  
  835. You can also change the video mode from a DOS SHELL and lcom will work fine
  836. in the new mode when you return; whether you configured that mode or not.
  837.  
  838.  
  839.  
  840.  
  841.  
  842.       O. CONTROLLING THE LCOM MENUS (SIZES, COLORS, POSITIONS, ETC.)
  843.  
  844.  
  845.  
  846.  
  847.  
  848. The Lcom Video program (LCV) is the means by which you can change the sizes,
  849. colors, and positions of each window.  Inside of the LCV program there are
  850. several initial options, the first of which is "configure windows".
  851. After going into that area, you will now be in a mockup of Lcom.  When you
  852. type the dialing directory key you will pull up a fake dialing directory.
  853. You can use the arrow keys to move the window around on the screen, or the
  854. shift-arrow keys to resize the window.  Pressing ALT-C takes you into a
  855. window whereby you can change the colors of that window.
  856.  
  857. There are several "default" color sets which you can load.  They are a window
  858. which you can reach by typing CTRL-ENTER.  In that window you could also save
  859. your favorite color set to one of the default slots in the lower section and
  860. then load it back into a different screen size.
  861.  
  862.  
  863.  
  864.  
  865.  
  866.                               P. ZOOMING
  867.  
  868.  
  869.  
  870.  
  871.  
  872. There are currently, two places where you can "zoom" in.  The first of which
  873. is the terminal window.  By pressing the (defaulted to) F5 key, you will switch
  874. between three different terminal windows.  The telephone directory also has
  875. the ability to zoom.  By pressing this same zoom key, you will expand the
  876. telephone directory to be able to view more information at one time.
  877. (see 'zoom' in telephone directory)
  878.  
  879.  
  880.  
  881.  
  882.  
  883.                    Q. VIEWING THE DOS SCREEN
  884.  
  885.  
  886.  
  887.  
  888.  
  889. You can view the dos screen, that is, the screen as it was before you ran
  890. Lcom (or after you left a shell) by pressing the View Dos Screen key.  This
  891. key is defaulted to be ALT-F5.  This key can be activated from almost all
  892. areas of Lcom.
  893.  
  894.  
  895.  
  896.  
  897.                 R. SAVING THE SCREEN (RECORD SCREEN)
  898.  
  899.  
  900.  
  901.  
  902. In Lcom you can "snapshot" the screen by using the "record screen" key.  This
  903. is defaulted to be ALT-S.  After you have told Lcom the name of the file you
  904. wish to save the screen to, you will then be prompted for what emulation you
  905. would like to use; TTY,ANSI, or LVI.  Basically, this means:
  906.  
  907.         TTY - No color
  908.         ANSI - Ansi color
  909.         LVI - LVI color
  910.  
  911. ANSI color is most likely the color coding system that you have when you type
  912. files out from DOS with the "type" command, and so you would most likely want
  913. to save to ANSI if you want to save in 'normal color'.  You may, however, wish
  914. to save it in LVI color (lcom's compressed color format).
  915.  
  916. If you ever want to save a block of the screen, you can do that by poping into
  917. the backscroll and using the backscroll block and save commands.
  918.  
  919.  
  920.  
  921.  
  922.                        S. PRINTING THE SCREEN
  923.  
  924.  
  925.  
  926.  
  927. ALT-P is defaulted to be the print screen key.  If ever you wish to send that
  928. which is currently displayed on the screen to the printer, this is the key you
  929. would want to use.  One again, if you ever want to only print a block, you
  930. can do that by poping into the backscroll and using the backscroll block and
  931. print commands.
  932.  
  933.  
  934.  
  935.  
  936.                    T. LOG TO FILE (protocol:ascii download)
  937.  
  938.  
  939.  
  940.  
  941. Log to file is the way by which you can save everything that comes in over the
  942. modem to a file.  Log-To-File in Lcom *IS* ASCII DOWNLOAD.  After pressing the
  943. Download key, you select the protocol as ASCII.  You will then be put into the
  944. Ascii Download window.  From there, you type in the filename which you want to
  945. log to <press enter>, and then you might <but don't have to> type in a format
  946. file to use. (see format files)
  947.  
  948. There are several options in the ascii download (area) of options.  One of them
  949. is, how you want to save the text.  In "Binary" format; everything you get goes
  950. directly to a file.. no questions asked (other than conforming to the carriage
  951. return and line feed translations).  Whereas, in text mode, if a character (for
  952. instance) 26 comes in over the modem, I will not write it to the file.. I'll
  953. change it to another symbol.  This is because character #26 symbolizes the end
  954. of a text file, and would cause you to not be able to view the entire file
  955. (without a smarter text editor).
  956.  
  957.  
  958.  
  959.  
  960.                           U. LOG TO PRINTER
  961.  
  962.  
  963.  
  964.  
  965. This is similar to the Log-To-File in that it records what comes in over the
  966. modem; except to the printer.  When you're done with the Log to printer
  967. feature, you press the same key that you started it with to stop it.  When
  968. you press that key, Lcom is not necessarily done printing.  It may have yet
  969. to finish off the current page, so do not shut the printer off until Lcom
  970. says it has finished and all the printing has stopped.
  971.  
  972.  
  973.  
  974.  
  975.  
  976.                 V. SENDING THE MODEM INIT STRING MANUALLY
  977.  
  978.  
  979.  
  980.  
  981. The Modem Initialization string is sent automatically when the program first
  982. boots up (unless it is configured otherwise) : as long as you are not online.
  983. The time may come when you would want to re-send it.  This can be done with
  984. the (send-modem-init-string-key). defaulted to ALT-O:utput init string.
  985.  
  986.  
  987.  
  988.  
  989.  
  990.                        W. HANGING UP THE MODEM
  991.  
  992.  
  993.  
  994.  
  995. Lcom's key to hang up the modem is defaulted to ALT-H.  Lcom's method of
  996. hanging up the modem is called "dropping the DTR".  This is the quickest method
  997. that could be used.  You may want to switch to the old method of hanging up
  998. the modem; which is for all intents and purposes, saying "hangup" to the modem
  999. with three +'s and an ATH0 instruction.  You would most likely only want to
  1000. switch to this method (in the config program) if dropping the DTR did not work
  1001. with your modem.
  1002.  
  1003.  
  1004.  
  1005.  
  1006.      
  1007.                         X. EXITING THE PROGRAM
  1008.  
  1009.  
  1010.  
  1011.  
  1012. To exit the program, you first type the exit-lcom-key (defaulted to ALT-X) and
  1013. then (normally) just press ENTER (or Y).  You could, however, type the 'W' key
  1014. and exit without executing the terminate-lcom-macro (defined in the config
  1015. program).
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.                               ┌─────────────┐
  1029.                               │AUTHORS NOTES│ 
  1030.                               └─────IV──────┘
  1031.  
  1032.  
  1033.  
  1034. If you have any questions or comments, you can call my Bulletin Board in
  1035. San Clemente, CA. (714) 492-3804 (from July 4th to November 1st, 1991), (that
  1036. time frame given so that if I should take the BBS down that I don't continue to
  1037. get phone calls on that line).  If I should keep the BBS up longer, then the
  1038. range will change in future versions of Lcom; and there WILL be future
  1039. versions.
  1040.  
  1041. If you wish to contribute to the further versions of Lcom, you can send
  1042. a $20 donation to:
  1043.  
  1044.         John Bushnell
  1045.              attn: Lcom
  1046.         401 Calle Robles
  1047.         San Clemente, Ca. 92672
  1048.  
  1049.                                                            - John Bushnell
  1050.  
  1051.  
  1052.  
  1053. This program compiled using Borland C, v2.0 and Turbo Assembler, v2.5.
  1054.  
  1055.  
  1056.